Expressions/ko

Other languages:

개요

수학적 표현식을 사용하여 속성을 정의할 수 있습니다. 표현식으로 속성이 정의되면 GUI 입력란 오른쪽의 수학식을 상징하는 아이콘 은 회색에서 파란색으로 바뀝니다. 아이콘을 클릭하거나 등호 =를 입력하면 해당 속성에 대한 표현식 편집기가 열립니다. 입력란에 아이콘 대신 ... 버튼이 표시되는 경우 속성을 마우스 오른쪽 버튼으로 클릭하고 상황에 맞는 메뉴에서 표현식...을 선택하면 표현식 편집기를 열 수 있습니다.

FreeCAD 표현식은 아래에 설명된 표준 수학 연산자, 함수 및 미리 정의된 상수를 사용하는 수학적 표현식입니다. 또한 표현식은 개체 속성을 참조할 수도 있고 조건문을 사용할 수도 있습니다. 표현식의 숫자에는 선택적으로 단위가 붙을 수 있습니다.

숫자에는 쉼표 , 또는 소수점 .을 사용하여 숫자와 소수점을 구분할 수 있습니다. 소수점 표시를 사용할 때에는 '반드시' 숫자가 하나 이상 뒤에 와야 합니다. 따라서 표현식 1. + 2.와 1, + 2,는 유효하지 않지만, 1.0 + 2.0과 1,0 + 2,0은 유효한 표현입니다.

연산자와 함수는 단위를 인식하며, 단위를 넣을 경우 유효한 단위 조합이 필요합니다. 예를 들어, 2mm + 4mm는 유효한 표현식이지만, 2mm + 4는 유효하지 않습니다. 이 규칙은 길이 속성과 같이 단위가 있는 개체 속성에 대한 참조에도 적용됩니다. 따라서 Pad001.Length + 1은 길이 단위가 있는 속성에 순수한 숫자를 추가하므로 유효하지 않습니다. Pad001.Length + 1mm처럼 단위를 붙여햐 합니다.

일부 단위 관련 오류는 직관적이지 않은 것처럼 보일 수 있으며, 표현식이 거부되거나 설정된 속성의 단위와 일치하지 않는 결과가 생성될 수 있습니다. 다음은 몇 가지 예입니다.

1/2mm is not interpreted as half a millimeter but as 1/(2mm), resulting in: 0.5 mm^-1.

sqrt(2)mm is not valid because the function call is not a number. This has to be entered as sqrt(2) * 1mm.

함수의 인수

함수에 다수의 인수를 전달할 때는 세미콜론 ;이나 쉼표 뒤에 공백 , 으로 구분합니다.(예: sum(10;20)또는 sum(10, 20) ) 후자의 경우, 쉼표는 입력 후 세미콜론으로 자동으로 변환되며 만일 쉼표 뒤에 공백이 없다면 이 경우 두 개의 인수가 아닌 10.2라는 하나의 인수로 인식하여 의도하지 않은 결과를 얻을 수 있습니다. 세미콜론을 사용하면 공백이 필요하지 않고 실수를 예방할 수 있습니다.

인수에는 스프레드시트의 셀에 대한 참조가 포함될 수 있습니다. 셀 참조시에는 셀의 대문자 열 뒤에 행 번호를 사용합니다(예: A1). 셀은 또한 별칭(예: Spreadsheet.MyPartWidth)을 사용하여 참조될 수 있습니다.

객체 참조

위에서 이미 본 것처럼, 데이터Name으로 객체를 참조할 수 있습니다. 하지만 데이터Label을 사용할 수도 있습니다. 데이터Label의 경우 <<와 >> 기호를 두 개 사용하여 묶어야 합니다(예: <<Label>>).

표현식에서는 객체의 어떤 속성이든 참조할 수 있습니다. 예를 들어, Cylinder의 높이를 참조하려면 Cylinder.Height 또는 <<Label_of_cylinder>>.Height를 사용할 수 있습니다.

객체 참조에 대한 자세한 내용은 CAD 데이터 참조를 부분을 보세요.

연산자자	설명
+	덧셈
-	뺄셈
*	곱
/	부동 소수점 나눗셈
%	나머지
^	지수화

함수	설명	입력값 범위
`acos(x)`	Arc cosine	-1 <= x <= 1
`asin(x)`	Arc sine	-1 <= x <= 1
`atan(x)`	Arc tangent, return value in the range -90° < value < 90°	all
`atan2(y; x)`	Arc tangent of y/x accounting for quadrant, return value in the range -180° < value <= 180°	all, the invalid input x = y = 0 returns 0
`cos(x)`	Cosine	all
`cosh(x)`	Hyperbolic cosine	all
`sin(x)`	Sine	all
`sinh(x)`	Hyperbolic sine	all
`tan(x)`	Tangent	all, except x = n*90 with n = odd integer
`tanh(x)`	Hyperbolic tangent	all
`hypot(x; y)`	Pythagorean addition (hypotenuse), e.g. hypot(4; 3) = 5	x and y >= 0
`cath(x; y)`	Given hypotenuse, and one side, returns other side of triangle, e.g. cath(5; 3) = 4	x >= y >= 0

함수	설명	입력값 범위
`exp(x)`	지수 함수(Exponential function)	all
`log(x)`	자연 로그(Natural logarithm)	x > 0
`log10(x)`	상용 로그(Common logarithm)	x > 0
`pow(x; y)`	Exponentiation	all
`sqrt(x)`	제곱근(Square root)	x >= 0
`cbrt(x)` introduced in version 0.21	세제곱근(Cubic root)	all

함수	설명	입력값 범위
`abs(x)`	절대값(Absolute value)	all
`ceil(x)`	천정 함수(Ceiling function), x보다 크거나 같은 최소 정수 값	all
`floor(x)`	바닥 함수(Floor function), x보다 작거나 같은 최대 정수 값	all
`mod(x; y)`	x를 y로 나눈 나머지, 결과의 부호는 피제수의 부호와 같습니다.	all, except y = 0
`round(x)`	가장 가까운 정수로 반올림	all
`trunc(x)`	0 방향의 가장 가까운 정수로 잘라내기	all

함수	설명	입력값 범위
`average(a; b; c; ...)`	인수의 산술 평균값으로 , sum(a; b; c; ...) / count(a; b; c; ...)와 동일합니다.	all
`count(a; b; c; ...)`	일반적으로 셀 범위에 사용되는 인수의 개수(Count)	all
`max(a; b; c; ...)`	인수의 최대(Maximum)값	all
`min(a; b; c; ...)`	인수의 최소(Minimum)값	all
`stddev(a; b; c; ...)`	Standard deviation of the values of the arguments	all
`sum(a; b; c; ...)`	인수 값의 합계(Sum)는 일반적으로 셀 범위에 사용됩니다.	all

Type	Function	Description
`Tuple`	`tuple(a; b; ...)`	Example: `tuple(2; 1; 2)`
`List`	`list(a; b; ...)`	Example: `list(2; 1; 2)`
`Vector`	`vector(x; y; z)`	Create a vector using three unit-less or `Length` unit values. Example: `vector(2; 1; 3)`
`Vector`	`create(<<vector>>; x; y; z)`
`Matrix`	matrix( a₁₁; a₁₂; a₁₃; a₁₄; a₂₁; a₂₂; a₂₃; a₂₄; a₃₁; a₃₂; a₃₃; a₃₄; a₄₁; a₄₂; a₄₃; a₄₄ )	Create a 4x4 matrix in row-major order: ${\begin{bmatrix}a_{11}&a_{12}&a_{13}&a_{14}\\a_{21}&a_{22}&a_{23}&a_{24}\\a_{31}&a_{32}&a_{33}&a_{34}\\a_{41}&a_{42}&a_{43}&a_{44}\\\end{bmatrix}}$ A minimum of 1 argument can be supplied such as `matrix(1)` which creates an identity matrix. Example: `matrix(1; 2; 3; 4; 5; 6; 7; 8; 9; 10; 11; 12; 13; 14; 15; 16)`
`Matrix`	`create(<<matrix>>; a₁₁; a₁₂; ...; a₄₄)`
`Rotation`	`rotation(axis; angle)`	Create a `Rotation` by specifying its `axis` (`Vector`) and `angle` (`Angle` unit or unit-less), or three Euler angles `α`, `β`, `γ`. Examples: `rotation(vector(0; 1; 0); 45)` `create(<<rotation>>; 30; 30; 30)`
	`rotation(α; β; γ)`
	`create(<<rotation>>; axis; angle)`
	`create(<<rotation>>; α; β; γ)`
`Placement`	`placement(base; rotation)`	Create a `Placement` with various parameters, including: `base`: base location (`Vector`) `center`: center location (`Vector`) `rotation`: `Rotation` `axis`: Rotation axis (`Vector`) `angle`: Rotation angle (unit-less or `Angle` unit value) `matrix`: `Matrix` Examples: `placement(vector(2; 1; 3); rotation(vector(0; 0; 1); 45))` `create(<<placement>>; create(<<vector>>; 2; 1; 2); create(<<rotation>>; create(<<vector>>; 0; 1; 0); 45))`
	`placement(base; rotation; center)`
	`placement(base; axis; angle)`
	`placement(matrix)`
	`create(<<placement>>; ...)`

함수 / 연산자	설명
`v1 + v2`	두 향량의 덧셈.
`v1 - v2`	두 향량의 뺄셈.
`v * s`	향량을 균일하게 `s` 배율 곱.
`vangle(v1; v2)`	두 향량 사이의 각도
`vcross(v1; v2)`	Cross product of two vectors $v_{1}\times v_{2}$ .
`v1 * v2`	Dot product of two vectors $v_{1}\cdot v_{2}$ .
`vdot(v1; v2)`	Dot product of two vectors $v_{1}\cdot v_{2}$ .
`vlinedist(v1; v2; v3)`	Distance between vector `v1` and a line through `v2` in direction `v3`.
`vlinesegdist(v1; v2; v3)`	Distance between vector `v1` and the closest point on a line segment from `v2` to `v3`.
`vlineproj(v1; v2; v3)`	Project vector `v1` on a line through `v2` in direction `v3`.
`vnormalize(v)`	Normalize a vector to a unit vector.
`vplanedist(v1)`	Distance between vector `v1` and a plane defined by a point `v2` and a normal `v3`.
`vplaneproj(v1)`	Project vector `v1` on a plane defined by a point `v2` and a normal `v3`.
`vscale(v; sx; sy; sz)`	Non-uniformly scale a vector by `sx` in the X direction, `sy` in the Y direction, and `sz` in the Z direction.
`vscalex(v; sx)`
`vscaley(v; sy)`
`vscalez(v; sz)`

Function	Description
`minvert(m)`	Calculate the Inverse matrix.
`mrotate(m; rotation)`	Rotate by either: a `Rotation` an axis (`Vector`) and an angle (`Angle` unit or unit-less) three Euler angles `α`, `β`, `γ`
`mrotate(m; axis; angle)`
`mrotate(m; α; β; γ)`
`mrotatex(m; angle)`	Rotate around the X axis.
`mrotatey(m; angle)`	Rotate around the Y axis.
`mrotatez(m; angle)`	Rotate around the Z axis.
`mtranslate(m; vector)`	Translate by a `vector` (`Vector`) or X, Y, Z values. If a `Rotation` is translated, the returned object is a `Placement`.
`mtranslate(m; x; y; z)`
`mscale(m; vector)`	Scale by a `vector` (`Vector`) or X, Y, Z values.
`mscale(m; x; y; z)`	Scale by a `vector` (`Vector`) or X, Y, Z values.

연산자	설
==	양 쪽이 같다
!=	같지 않다
>	왼쪽이 오른쪽 보다 크다
<	왼쪽이 오른쪽 보다 작다
>=	왼쪽이 오른쪽 보다 크거나 같다
<=	왼족이 오른쪽 보다 작거나 같다

단위	설명
°	Degree; alternative to the unit deg
deg	Degree; alternative to the unit °
rad	Radian
gon	Gradian
S	Second of arc; alternative to the unit ″
″	Second of arc; alternative to the unit S
M	Minute of arc; alternative to the unit ′
′	Minute of arc; alternative to the unit M

상수	설명
e	Euler's number
pi	Pi

단위	설명
mmol	밀리몰(Millimole)
mol	몰(Mole)

단위	설명
mA	Milliampere
A	암페어(Ampere)
kA	Kiloampere
MA	Megaampere

단위	설명
pF	Picofarad
nF	Nanofarad
uF	Microfarad; alternative to the unit µF
µF	Microfarad; alternative to the unit uF
mF	Millifarad
F	패럿(Farad); 1 F = 1 s^4·A^2/m^2/kg

단위	설명
uS	Microsiemens; alternative to the unit µS
µS	Microsiemens; alternative to the unit uS
mS	Milli지멘스
S	Siemens; 1 S = 1 s^3·A^2/kg/m^2
kS	KiloSiemens
MS	MegaSiemens

단위	설명
nH	Nanohenry
uH	Microhenry; alternative to the unit µH
µH	Microhenry; alternative to the unit uH
mH	Millihenry
H	헨리; 1 H = 1 kg·m^2/s^2/A^2

단위	설명
Ohm	옴(Ohm); 1 Ohm = 1 kg·m^2/s^3/A^2
kOhm	Kiloohm
MOhm	Megaohm

단위	설명
mJ	Millijoule
J	줄(Joule)
kJ	Kilojoule
eV	Electronvolt; 1 eV = 1.602176634e-19 J
keV	Kiloelectronvolt
MeV	Megaelectronvolt
kWh	Kilowatt hour; 1 kWh = 3.6e6 J
Ws	와트시; alternative to the unit Joule
VAs	Volt-ampere-second; alternative to the unit Joule
CV	Coulomb-volt; alternative to the unit Joule
cal	칼로리(Calorie); 1 cal = 4.184 J
kcal	Kilocalorie

단위	설명
mN	Milli뉴튼(newton)
N	Newton
kN	Kilonewton
MN	Meganewton
lbf	Pound of force

단위	설명
nm	Nanometer
um	Micrometer; alternative to the unit µm
µm	Micrometer; alternative to the unit um
mm	Millimeter
cm	Centimeter
dm	Deci미터(Meter)
m	Meter
km	Kilometer
mil	Thousandth of an inch; alternative to the unit thou
thou	Thousandth of an inch; alternative to the unit mil
in	Inch; alternative to the unit "
"	Inch; alternative to the unit in
ft	Foot; alternative to the unit '
'	Foot; alternative to the unit ft
yd	Yard
mi	Mile

단위	설명
ug	Microgram; alternative to the unit µg
µg	Microgram; alternative to the unit ug
mg	밀리그램
g	그램
kg	킬로그램
t	톤
oz	Ounce
lb	Pound; alternative to the unit lbm
lbm	Pound; alternative to the unit lb
st	Stone
cwt	Hundredweight

단위	설명
Pa	파스칼
kPa	Kilopascal
MPa	Megapascal
GPa	Gigapascal
uTorr	Microtorr; alternative to the unit µTorr
µTorr	Microtorr; alternative to the unit uTorr
mTorr	Millitorr
Torr	Torr; 1 Torr = 133.32 Pa
psi	Pound-force per square inch; 1 psi = 6.895 kPa
ksi	Kilopound-force per square inch

단위	설명
uK	Microkelvin; alternative to the unit µK
µK	Microkelvin; alternative to the unit uK
mK	Millikelvin
K	켈빈

단위	설명
s	초
min	분
h	시간
Hz (1/s)	헤르츠
kHz	Kilohertz,
MHz	Megahertz
GHz	Gigahertz
THz	Terahertz

Expressions/ko

개요

함수의 인수

객체 참조

지원되는 상수

지원되는 연산

지원되는 함수

일반 수학 함수

삼각 함수

지수 함수와 대수 함수

반올림, 잘라내기 및 나머지 함수

통계/집계 함수

문자열 조작

문자열 식별

문자열 연결

문자열 변환

문자열 서식

객체 생성 함수

향량(Vector) 함수

행렬 함수

조건식

단위

물질의 양

각도

전류

정전 용량

전하량

전기 전도도

전기 유도용량

전위

전기 저항

능량(能量, Energy)/일(work)

힘(Force)

길이

Luminous intensity

자속(磁束)

자속밀도

질량

전력(電力, Power)

압력

온도

시간

부피

Special imperial units

지원되지 않는 단위

잘못된 문자 및 이름

표지(Labels)

이름

셀 별명

CAD 데이터 참조

순환 종속성

문서 전체 전역 변수

문서 사이 연결

알려진 문제 / 남은 작업

스크립트

단위	설명	대체
°C	Celsius	[°C] + 273.15 K
°F	Fahrenheit;	([°F] + 459.67) × 5/9
u	Atomic mass unit; alternative to the unit Da	1.66053906660e-27 kg
Da	Dalton; alternative to the unit u	1.66053906660e-27 kg
sr	Steradian	not directly
lm	Lumen	not directly
lx	Lux	not directly
px	Pixel	not directly

문자 / 문자열	Description
+, -, *, /, ^, _, <, >, (, ), {, }, [, ], ., ,, =	수학 연산자 또는 수학 구성의 일부인 문자
A, kA, mA, MA, J, K, ' , ft , °, 기타 등등!	단위인 문자 및 문자 시퀀스(단위 문단 참조)
#, !, ?, §, $, %, &, :, ;, \, \|, ~, ∆, ¿, 기타 등등!	자리 표시자로 사용하거나 특수 작업을 유발하는 데 사용되는 문자
pi, e	수학 상수
´, `, ' , "	강조에 사용되는 문자
공백	공백은 이름의 끝을 정의하므로 사용할 수 없습니다.

CAD 데이터	표현식에서 호출	결과
상자의 길이	`Box.Length`	길이 (단위: mm)
상자의 부피	`Box.Shape.Volume`	mm&sup3 단위의 부피
Shape type of the Box	`Box.Shape.ShapeType`	String: Solid
Label of the Box	`Box.Label`	String: Label
X-coordinate of center of mass of the Box	`Box.Shape.CenterOfMass.x`	X-coordinate in mm without units
X-coordinate of the Box placement	`Box.Placement.Base.x`	X-coordinate with units (mm)
X-component of the rotation axis of the Box placement	`Box.Placement.Rotation.Axis.x`	X-component of the unit vector in mm without units
Rotation angle of the Box placement	`Box.Placement.Rotation.Angle`	Rotation angle with units (deg)
Full Box object	`Box._self`	Object of type <Part::PartFeature>
Value of constraint in a sketch	`Constraints.Width`	Numeric value of the named constraint `Width` in the sketch, if the expression is used in the sketch itself.
Value of constraint in a sketch	`MySketch.Constraints.Width`	Numeric value of the named constraint `Width` in the sketch, if the expression is used outside of the sketch.
Value of a spreadsheet alias	`Spreadsheet.Depth`	Value of the alias `Depth` in the spreadsheet `Spreadsheet`
Value of a local property	`Length`	Value of the 데이터Length property in e.g a Pad object, if the expression is used in e.g 데이터Length2 in the same object.